So we keep putting our trust in things that rust
And then we feel the pain of loss
(James, "Stripmining")

Bugs, Problems and Limitations

Known bugs

• For missing end-tags, the position of the last occurence of the start-tag with the same name is reported as correspondig start-tag.
• I'm still not sure, if GETSIZE for GIF89a can handle everything correct - but hopefully it does. I've never seen such an idiotic image-format before
• I'm still not sure, if GETSIZE for JFIF/JPEG can handle everything correct - but hopefully it does. I've really never seen such an idiotic, braindead, ill-minded and chaoticly structured image-format before.

Known problems (to be fixed)

• Most NEXT and PREV buttons of the docs don't fit; I just wanted to show how to create a navigation bar, but I'm too lazy to maintain it while the structure of the documention isn't fixed.
• Some parts of the docs still need some improvement (like the chapter about messages)
• As I know myself, these documents still contain loads of typos and `strange english'..

Known problems

• URI checking is performed via trying to open a file. As AmigaOS is case-insensitive dealing with filenames, problems might occure when copying the html-object-tree to a case-sensitive filesystem. I recommend to rebuild the whole project at the target system.
• If you specify a <BASE HREF="..">, hsc is unable to find out how the base is related to the destination-directory and will treat all local URIs like external ones; Absolute URIs aren't possible with a base-URI set, of course.
• For projects larger 500 documents, scanning the project-file on every run takes a awful lot of time; due the lack of any portable concept of keepind data resident after a program exits, there is no workaround for this (same problem like with hsc.prefs); you will have to get rid of the project-file and hscdepp for such projects.
• The obsolete tags <LISTING> and <XMP> might not be treated correctly, as the behavior of these two seems so be not very strickly definded. You should avoid them anyway and use <PRE> or <$source> instead.
• hsc doesn't care much about filenames and their limitations; if, for example, a filename gets too long, it depends on fopen() of your compiler whether an error is reported or the filename is truncated. If you insist on filenames containig 46587643 characters, hsc can cope with it - but your OS probably won't.
• Out-of-memory can cause small memory-leaks. This is because hsc uses a special malloc()-function which just displays an error message and quits using exit(). As hsc keeps track of all allocated resources, it will release everything that could be fully initialised and made it into its supposed resource-list. For out-of-memories during partially initialising complex structures, this failes and can cause memory-leaks (normally approx. 100-500 bytes). Usually, these are handled by your OS or, as for AmigaOS, by the malloc()-function of the run-time-library, so you shouldn't bother too much about that. Blame K&R for their braindamaged memory-managment concepts.

Limitations